home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / mel_163.zip / SYSOP.DOC < prev    next >
Text File  |  1991-10-06  |  20KB  |  332 lines

  1.        ==============  MELEE v1.61 (Beta Release)  ===============
  2.                   An FRPG Gladiatorial Combat On-Line Game
  3.                        Written by Kevin L. Higgins
  4.                           FidoNet Node 1:128/74
  5.                           V-Net Node: 1:521/101
  6.  
  7. ===============================================================================
  8. In addition to the above addresses for NetMail, Kevin Higgins may be reached
  9. in the following FidoNet echos: DOORWARE, DOORGAMES, ON_LINE_GAMES and MELEE
  10. (which is on the V-NET backbone, and is also available from 1:128/74; for
  11. information F'Req the file MEL_ECHO.ZIP to find out the list of MELEE hubs).
  12. The MELEE Support BBS is The Hornet's Nest (719) 579-0593. It is a semi-private
  13. BBS, but queries may be sent to the SysOP by logging on as GUEST and giving
  14. the password HELLO. You will only be allowed to leave a (K)omment to the 
  15. SysOp, who also happens to be MELEE's author. NetMail will also be accepted.
  16. If you send NetMail with questions about MELEE, and are not a registered
  17. system, you must poll a day or two later to receive your response, since the
  18. cost of supporting non-registered systems has proven to be prohibitive.
  19. ===============================================================================
  20. Files included in this archive:
  21.      The following files should be included in this archive. If any files
  22. are missing, you have gotten an incomplete archive. If your archive is not
  23. complete, please do not distribute it. You may always obtain the latest,
  24. complete, version of MELEE by downloading it from The Hornet's Nest BBS
  25. (USA (719)579-0593 -- first time access for MELEE downloads) or by File
  26. Requesting it from FidoNet Node 1:128/74 using the magic name of MELEE.
  27.  
  28.        Name                Description
  29. -------------------------------------------------------------------------
  30.      Arena.ans           Ansi file of the combat arena
  31.      Armor.dat           Armor data values and costs
  32.      Beam.ans            Ansi file of The Beam combat environment
  33.      Cage.ans            Ansi file of The Cage combat environment
  34.      Cmbrule.txt         An explanation MELEE's blood-match challenge protocol
  35.      Disclaim.txt        Author's disclaimer and License info. Must read!
  36.      FightEnv.txt        An explanation of the combat environments
  37.      Helm.dat            Helmet data values and costs
  38.      Howfight.txt        An explanation of the combat screen and how to fight
  39.      Maint.exe           The MELEE nightly maintenance program
  40.      Melee.cfg           The DOS text configuration file. Must edit!
  41.      Melee.doc           MELEE Players' game documentation
  42.      Melee.exe           The MELEE main program
  43.      Melee.ovr           Main program overlay file
  44.      Mudpit.ans          Ansi file of The Mudpit combat environment
  45.      NPC_gen.exe         MELEE combat android generation program
  46.      NPCguys*.dat        Combat androids data files. * = 1-5 (level of android)
  47.      NPCscrp*.dat        Combat androids script files
  48.      Order.frm           Info on registering your copy of MELEE
  49.      Pattern.ans         The Pattern-recognition template for Intel development
  50.      Profexpl.txt        An explanation of the fighting proficiencies
  51.      QBBSbeta.doc        A caveat for those running QBBS 1.75 beta
  52.      Rankings.ans        The ansi file used as a base for the ANSI bulletin
  53.      Rankings.exe        The MELEE Warriors/Androids rankings program
  54.      Readthis.now        Important supplementary info for each release
  55.      Sands.ans           Ansi file of The Sands combat environment
  56.      Screen.ans          Ansi file of The Arena combat environment
  57.      Shield.dat          Shield data values and costs
  58.      Statinfo.txt        Information on the MELEE Warrior characteristics
  59.      SysOp.doc           Sysop's documentation. How to set up and run MELEE
  60.      Tactics.ans         Ansi file used as a base for script determination
  61.      Tactics.txt         An explanation on the various MELEE script tactics
  62.      Update.asc          A history of improvements and bug-fixes
  63.      Warrior.bat         Sample batch file for running MELEE from a BBS
  64.      Weapon.dat          Weapon file for data values and costs
  65. -----------------------------------------------------------------------------
  66.      
  67.  
  68.  
  69. Please:
  70.      Read the file Disclaim.txt, included this the MELEE archive. If this
  71. archive does not contain the file Disclaim.txt, it is not an authorized
  72. MELEE archive and should be deleted. Any use of MELEE constitutes consent to
  73. the conditions outlined in the file Disclaim.txt. Take a look at the Order.Frm
  74. file. You may want to fill it out one of these days.....
  75.  
  76.      Make sure you follow the instructions in the READTHIS.NOW file!!!
  77.  
  78.      See the UPDATE.ASC for fixes/changes since the last version. Leave it in
  79. the MELEE directory, since the game allows your interested users to view this
  80. also.
  81. ===============================================================================
  82.     SETUP:
  83.  
  84.     1) Unzip the MEL_160.ZIP archive into a directory of your choice. If you
  85. are upgrading from a previous version, a conversion is necessary. Follow the
  86. instructions in the READTHIS.NOW file if you have not already. Then merely
  87. unzip MELEE into your MELEE directory, overwriting any old MELEE files with
  88. the new ones in this version. It is your option whether or not you want to
  89. replace the combat androids files (NPCGUYS#.DAT and NPCSCRP#.DAT).
  90.  
  91.     2) Edit the included MELEE.CFG file to reflect your board's info. It
  92. is well commented, so you should have no problems. Remember to include trailing
  93. backslashes on all of the path/names required! Don't forget to make the
  94. directory where the messages will go.... Editing the .cfg file should be done
  95. with your favorite ascii-text editor. Most "RunTime Error 003" problems are
  96. a result of incorrectly naming your directories here.
  97.        Don't forget to create the IMPORTS directory directly above the MELEE
  98. directory (eg., \MELEE\IMPORTS) if you ever plan on importing visiting
  99. Warriors into your game.
  100.     NOTE: If you run MELEE on a multi-nodal system, you may feed MELEE a single
  101. command line parameter which should be the name of the .cfg file which you want
  102. MELEE to read for that particular node.
  103.     WARNING: As of this release, MELEE still does not do ALL the file locking
  104. necessary to make running it on two nodes simulataneously a good idea. Most
  105. of the file locking/unlocking is completed, but the author recommends waiting
  106. until the next version before running the game simultaneously on two nodes.
  107. There is a chance that under multi-nodal usage, MELEE might be instructed to
  108. read/write to the same record by two different nodes..... data file corruption
  109. could very well result. Beta testing for the multi-nodal version will begin in
  110. October/November, 1991.
  111.  
  112.     3) An Exitinfo.bbs file is not required; it will not be used if present.
  113.  
  114.     4) Put the included WARRIOR.BAT file in the directory where you have
  115. all your other door .bat files. Edit it so that it changes the current
  116. directory to the one in which MELEE's files reside, then changes back to the 
  117. bbs directory upon completion. (Simple, eh?) If you run a QBBS beta, then
  118. make sure your read the included file: QBBSBETA.DOC.
  119.  
  120.     NOTE: MELEE may be run independent of a BBS, or without a fossil by
  121. feeding it a command line parameter. If, after the name of the program, you
  122. leave a space and then feed the program an "L" parameter (without the quotes,
  123. of course), MELEE will prompt the player for his name. Or if you do not wish to
  124. use MELEE's communications routines (say, you prefer to use Doorway, or run
  125. a BBS which can handle ALL the communications on its own) and run a board
  126. which can feed a program command line parameters, then make MELEE's three
  127. parameters the user name and time left, and MELEE will use that. This is ideal
  128. for those who cannot, or do not want to, run a FOSSIL driver.
  129.     Examples:
  130.           a) For non-bbs usage:
  131.                     MELEE L
  132.              This is for non-BBS usage. MELEE will prompt for a user name.
  133.              Time left defaults to 90 minutes. Communications routines are
  134.              bypassed.
  135.  
  136.           b) Other-program comm routines, feed MELEE three command line
  137.              parmeters:
  138.                     MELEE %1 %2 %3
  139.              MELEE will use %1 and %2 as the user name (first and last), and
  140.              the %3 parameter (which must be an integer) will be used by MELEE
  141.              to set the user's time remaining.
  142.              NOTE: When you feed MELEE any command-line parameters OTHER THAN
  143.              the name of the config file (something that should only be done
  144.              if you run a multi-nodal system) then ALL of MELEE's comm
  145.              routines are disabled, and it no longer checks for or uses a
  146.              FOSSIL driver.
  147.              NOTE: In order to run the registered version of MELEE when you
  148.              are either not using a BBS or not using a dropfile, you must
  149.              have the file MELEE.INF in the MELEE directory. MELEE.INF is a
  150.              plain ascii file with the following format:
  151.              Line 1:    Registerer's First Name
  152.              Line 2:    Registerer's Last Name
  153.              Line 3:    BBS or Company Name or System Identifier requested when
  154.                         the registration form was submitted (do not have the
  155.                         "Line 1:" etc., in the file....).
  156.              Line 4:    Amount of time you want the player to have in the game.
  157.  
  158.     5) Run the program MAINT.EXE once a day (preferably in your midnight
  159. events) from within the MELEE directory. This will reset some of the local
  160. values needed for the players to train their characters, and age the Warriors
  161. (one month/day of real time). There is no advantage to running the MAINT.EXE
  162. program more than once a day and it is not recommended.
  163.  
  164.     6) At your option, run the RANKINGS.EXE program during your nightly
  165. events (from within the MELEE directory) to generate a nice looking rankings
  166. bulletin. The rankings program will not run if there is no Player.dat file
  167. (ie, no players in the game... makes sense, eh?). If you are going to run it,
  168. the RANKINGS.EXE program should be run AFTER the maintenance program. In order
  169. to work, the directories named in the MELEE.CFG file must exist and be spelled
  170. correctly. Since both the Maint.exe and Rankings.exe program have security
  171. checks to prevent against hacking and virus infection, it is not recommended
  172. that they be run in the same batch file which calls the door, since the checks
  173. take several long seconds.... At this time, the protective measures prevent
  174. compression of any of the MELEE .exe files using such programs as PKLite,
  175. Diet, or LZEXE. Do not use a binary editor to alter any MELEE files or the
  176. game will abort. Customized versions of MELEE can be compiled for systems
  177. registering the game, for a small additional fee. The rankings file will
  178. exit gracefully if you have less than four Warriors to be ranked, or more than
  179. 21. If you don't have the requisite 4 players, the program will still import
  180. Warriors you may have gotten from another system.
  181.  
  182.     7) Run the game! Local/Remote mode will be automatically determined
  183. from the ComPort value in the DORINFO or DOOR.SYS file so no special settings
  184. are needed if you are running the game from a dropfile-producing BBS (ie.,
  185. using dorinfo#.def or door.sys files for user data).
  186.  
  187.     8) The game will report any problems in the PROG_ERR.LOG (for the 
  188. main game) and the RANK_ERR.LOG (for the bulletin generator), or the
  189. MAINTERR.LOG (for the maintenance program) files.
  190.  
  191.     9) Special Keys: F5  will hang up on the user immediately, unless the modem
  192.                          has carrier detect forced to ON (drops DTR for 700 ms).
  193.                          No message is sent to the player what-so-ever.
  194.                      F9  will force the player to return to the BBS.
  195.                      F10 will pull the user into Chat. Hit [Esc] to exit Chat.
  196.  
  197.     10) If you place the game's .doc and .txt files in an archive and make
  198. it available to your players/users, it will help them quickly grasp the more
  199. subtle ins-and-outs of the game, thus promoting their enjoyment and enhancing
  200. their rapid climb to the top of the rankings.
  201.  
  202.     The game can be reset by merely deleting the Player.dat file and the
  203. messages in the private file directory and then running the Maint.exe program.
  204. Deleting the files in the private messages directory is not necessary, but is
  205. highly recommended....
  206.  
  207.     PLEASE: When you or a user have a bug report, be SPECIFIC. When updates
  208. are released, they will be available from 1:128/74 under the magic filename:
  209. BUGFIX. The magic filename MELEE will always get you the latest release.
  210. With the exception of the month of September, 1991, the author is active in the
  211. FidoNet DoorWare, On_Line_Games, and DoorGames echos. Bug-fixes can be sent
  212. to 1:128/74 via NetMail, or reported in the MELEE echo.
  213.  
  214.     Known Anomalies:
  215.      1) RANKINGS.EXE will not run if you have more than 21 players in
  216. the game or less than four players in the game (however, making extra players
  217. is simple, just edit the dorinfo file you create from a local exit from you
  218. BBS, and change the user name and run MELEE a few times.... soon you will have
  219. quite a stable of "resident" Warriors). If you get too many Warriors, lower
  220. the number of days until a Warrior is purged in the configuration file.
  221.      2) It is not advisable to enter CHAT while the program is waiting for
  222. the player to enter a line of text (Player Name, City Name, etc).
  223.  
  224.  
  225. Borland Turbo Pascal Error Messages you can get with MELEE:
  226.  
  227. Number Meaning                 With regards to MELEE
  228. ------ ----------------------- -------------------------------------------
  229.     2  File not found          You are missing a file.
  230.     3  Path not found          You likely have an incorrect path in the .cfg.
  231.     4  Too many open files     Increase your FILES= statement in your 
  232.                                CONFIG.SYS  We recommend about 25.
  233.     5  File access denied      Either a file has been set to read only, a
  234.                                directory is full, a RENAME tried to rename to
  235.                                an existing file name or a file is not open.
  236.     6  Invalid File Handle     Your file handles have become corrupted, DOS err.
  237.     
  238.   100  Disk Read Error         An attempt was made to read past the end of a 
  239.                                file most often.  Something is corrupted in the
  240.                                record pointers.
  241.   101  Disk Write Error        Generall an indication of a full hard disk.
  242.   103  File Not Open           File is closed when it shouldn't have been.
  243.   104  File Not Open for Input Text file is closed when it shouldn't have been.
  244.   105  File Not Open for Output "   "     "   "       "      "       "
  245.   
  246.   Errors 150 through 162 indicate various HARDWARE failures.  If you're getting
  247.   these, then something is wrong with your PC and I can't be of much help there.
  248.  
  249.   Some commone ones are:
  250.  
  251.   152  Drive not ready         Controller problem or drive not spinning
  252.   154  CRC error in data       Scrogged disk (real technical eh? (grin))
  253.   156  Disk Seek error            Head problem or bad controller
  254.   157  Unknown media type      Did you just change to DOS 4.0 or 5.0???
  255.   158  Sector not found        Head problem or bad controller
  256.   159  Printer out of paper    Hit Control P!  Disable printer logging.
  257.   160  Device write fault      Disk problem
  258.   161  Device read fault       Disk problem
  259.   162  Hardware Failure        "Generic" nasty, nasty problem.
  260.  
  261.   Fatal errors generally indicate a problem that must be fixed before you 
  262.   can continue to run the game.
  263.  
  264.   200  Division by zero        Now I hope you cannot make one of these happen
  265.                                as I check before every division to make sure
  266.                                it DOESN'T happen, but you it might.
  267.   201  Range Check Error       Array index out of range.
  268.   202  Stack Overflow          NOT ENOUGH MEMORY for the stack! You will have
  269.                                to register the game and be willing to pay the
  270.                                the author a small fee to compile a special,
  271.                                smaller memory version of MELEE for you to run.
  272.   203  Heap overflow error     Same as 202.
  273.   204  Invalid Pointer Op.     Can be caused the same as 202.
  274.   205  Floating point overflow Should not happen--this is a problem with using
  275.                                real numbers for mathmatical operations; MELEE
  276.                                does very little of these.
  277.   207  Invalid Floating point  You have a real thats trying to be converted to a
  278.        Operation               Long int and it's greater than 2 billion.
  279.   209  Overlay File read error MELEE had a problem getting an overlay from the
  280.                                MELEE.OVR file.  If you're not using EMS, then
  281.                                the .OVR file is missing or is setting on a bad
  282.                                sector on your harddisk.  If you are running EMS
  283.                                then you have a bad memory chip! (yegads!)
  284.  
  285. Well this covers a large portion of the technical support for MELEE.  If you
  286. have further questions, contact the author at (719)579-0690 (data), or Fido-
  287. Net 1:128/74, then call back later to receive your response.
  288.  
  289. Acknowledgements:
  290.  
  291.     First thanks goes to Alex Dwelis, for his tireless, consistent,
  292. detailed, and always helpful observations, instruction, and alpha testing.
  293. If you consider this game to be somewhat free of bugs, he is the one you
  294. have to thank. Any bugs you find are strictly my oversight, not his (but
  295. I am still not responsible for damages! <grin>). He also spent a great deal
  296. of his valuable time proof-reading the documentation, and compiling the
  297. "MELEE Hints For Canny Warriors" file, which will become available with the
  298. registered version if the demand warrants its creation.
  299.     Second, I would like to acknowledge the MELEE team of subsidiary
  300. Alpha and Beta testers. Their efforts went a long way toward making the game
  301. as it is today. They spent a lot more money on the game than it costs to 
  302. register it, and I owe them a debt of gratitude (and eternal free upgrades!).
  303.     Third, I would like to thank John Parlin and Rod Hancock for their
  304. superb product JPDoor, without which this door would never have been written;
  305. Kelly Drown, for her FidoUnit routines; Bruce Ruona, for his help with the use
  306. of Kelly Drown's routines <grin>; and Galen Barnes, for his patient help with
  307. the chat-screen capture/restore (he wrote all the important parts!); and the
  308. TAG Team, who wrote the great BBS that really got me involved in the remote-
  309. communications world, which in turn eventually impressed upon me the desire
  310. to learn to program. Thanks also to Donald Huggins (co-author of DoorFix, the
  311. best dropfile converter around), for his assistance during my very steep
  312. learning curve when first learning Turbo Pascal, and Mark McKay, for his help
  313. while I was laboring under TP ignorance, and Kevin Dean, for his excellent
  314. CRC-checking program. (Starting to sound like the Grammy's, eh?)
  315.     Lastly, I would like to thank my grandfather, Leslie Charteris, and
  316. my parents, for giving me the brains to teach myself Turbo Pascal, and churn
  317. out a program like this as my VERY first effort at coding in this language.
  318. If I've forgotten anybody who helped along the way, I'm sorry, and please
  319. accept my apologies. To all those who walk around spouting such B.S. as, "In
  320. order to write an enjoyable door, you must have been programming for at least
  321. a year (preferably two)," I feel the need to quote Bill the Cat: "Phlblblttt!"
  322. From learning the language (thanks to Tom Swan for writing the book I used as
  323. a tutorial) to first release was six months. Next one will be even quicker;
  324. Be watching for "Starship Troopers...."
  325.  
  326.                                                "Vasha Zdrovia!"
  327.                                                     Kevin Higgins
  328.                                                     10 Aug 91
  329.  
  330. <<Good Hunting>>
  331.  
  332.